feat(container): update image ghcr.io/navidrome/navidrome ( 0.61.2 → 0.63.2 ) - #1790

v0.63.2

Compare Source

Changelog

Bug fixes

• 205c85d: fix(plugins): surface host service failures when loading plugins (#​5756) (@​deluan)
• 7fa1376: fix(scanner): resolve file symlinks with the production local storage FS (#​5755) (@​deluan)
• e91687e: fix(smartplaylist): reject NSP mixing top-level 'any' and 'all' (#​5759) (@​deluan)

Build process updates

• be10f89: ci: don't skip release jobs after the DB migration check on tag pushes (#​5760) (@​deluan)
• 4381366: ci: validate DB migration order on pull requests (#​5750) (@​deluan)

Other work

• 116a440: test(scanner): fix flaky Windows search_normalized rescan test (#​5758) (@​deluan)

Full Changelog: navidrome/navidrome@v0.63.1...v0.63.2

Helping out

This release is only possible thanks to the support of some awesome people!

Want to be one of them?
You can sponsor, pay me a Ko-fi, or contribute with code.

Where to go next?

• Read installation instructions on our website.
• Host Navidrome on PikaPods or Danian for a simple cloud solution.
• Reach out on Discord, Reddit and Twitter!

v0.63.1

Compare Source

Changelog

Bug fixes

• 052f10f: fix(build): prevent 32-bit startup crash (segfault/SIGILL) in downloads binaries (#​5739) (@​deluan)
• f48943c: fix(plugins): discard buffered scrobbles when a plugin is removed (#​5737) (@​deluan)
• 4652b46: fix(plugins): populate username for buffered plugin scrobbles (#​5736) (@​deluan)
• 42d4363: fix(service): rewrite systemd service template for kardianos/service v1.3.0 (#​5743) (@​deluan)

Full Changelog: navidrome/navidrome@v0.63.0...v0.63.1

Helping out

This release is only possible thanks to the support of some awesome people!

Want to be one of them?
You can sponsor, pay me a Ko-fi, or contribute with code.

Where to go next?

• Read installation instructions on our website.
• Host Navidrome on PikaPods or Danian for a simple cloud solution.
• Reach out on Discord, Reddit and Twitter!

v0.63.0

Compare Source

Navidrome 0.63 brings a long-awaited upgrade to lyrics: full support for synced sidecar lyrics in multiple formats (TTML, ELRC, SRT, YAML and LRC), including word-by-word karaoke timing and multi-voice (agent) layers, exposed to clients through the new OpenSubsonic v2 lyrics extensions. A huge shoutout to @​ranokay, who not only contributed the code for these lyrics enhancements, but also helped shape the OpenSubsonic extension specification behind them. Search also gets noticeably smarter: exact matches now rank above prefix matches (searching for "MØ" brings MØ to the top instead of burying it), and artists with short or non-ASCII names that were previously unfindable now show up correctly.

The other big theme of this release is performance for large libraries and offline-first clients. Full-library synchronization via search3 (the way clients like Symfonium mirror the whole library) is now flat at every offset instead of degrading with depth, roughly 30-50x faster at deep offsets and about 20x faster for a complete sync on a ~1M-track library, and a related pagination-integrity fix eliminates the duplicate and short pages that could corrupt those syncs. Alongside it, getRandomSongs is about 13x faster on the same library size, and a batch of database improvements (annotation-index-friendly smart playlist filters, leaner list-count queries, and new composite indexes for album/artist song sorts) makes everyday operations anywhere from ~9x to ~160x faster. Finally, a heads-up on a behavior change: sharing is now enabled by default, and can be turned off with EnableSharing=false.

Security

• Enforce per-library access on playlist import and sharing paths. In multi-library setups, three read paths did not consistently apply per-library restrictions: M3U import path resolution, shared-playlist track loading, and public share-scoped streams. A user with access to only some libraries could resolve or be served tracks from libraries they weren't assigned to. All three now respect the user's (or share owner's) library access. (#​5640 by @​deluan)
• Resolve symlinks to their real target when classifying files during scan, preventing symlinked entries from being misclassified. (ecba19a08 by @​deluan)

Configuration Changes

For a complete list of all configuration options, see the Configuration Options documentation.

Lyrics

• Add structured sidecar lyrics support with OpenSubsonic v2 karaoke cues and agent layers: TTML, ELRC, SRT and YAML sidecar files are now parsed with word-by-word timing and multi-voice information. (#​5076 by @​ranokay)
• Allow lyrics plugins to return lyrics in any supported format, not just LRC. (#​5632 by @​deluan)
• Keep the player's lyrics in sync on track change and seek, so the previous song's lyrics no longer linger. (7303c9ca4 by @​deluan)

Search

• Rank exact matches above prefix matches in search results. (#​5704 by @​deluan)
• Fix artists with short or non-ASCII names being unfindable after the FTS5 search migration. (#​5703 by @​deluan)

UI

• Add Rosé Pine themes. (#​5664 by @​draconivis)
• Fix transient jump to a wrong song when switching tracks in the web player. (#​5676 by @​deluan)
• Fix profile self-edits not reporting success or failure. (#​5699 by @​deluan)
• Fix Nautiline theme font and width on mobile devices. (#​5590 by @​devBoi76)
• Fix DefaultLanguage not being applied on app startup. (#​4000 by @​deluan)

Scanner

• Add Scanner.ArtistSplitExceptions to protect artist names from being split by tag separators. (#​5701 by @​deluan)
• Add Scanner.IgnoreDotFolders to allow indexing dot-prefixed folders. (#​5568 by @​deluan)
• Fix playlists not being imported when the first scan runs before any admin user exists. (#​5609 by @​deluan)

Subsonic API

• Add OpenSubsonic work and movement attributes, improving classical music metadata for compatible clients. (#​5659 by @​deluan)
• Speed up getRandomSongs on large libraries with two-phase random selection, about 13x faster on a 1M-track library. (#​5618 by @​deluan)
• Speed up artist search3 pagination at deep offsets, roughly 5-8x faster on a 300K-artist library. (#​5620 by @​deluan)
• Speed up search3 empty-query (browse-all) pagination: response times are now flat at any offset, 30-50x faster at deep offsets, making a full ~1M-track library sync about 20x faster overall. (#​5601 by @​deluan)
• Make "recently added" album order reproducible and consistent with the RecentlyAddedByModTime setting. (#​5678 by @​deluan)

Smart Playlists

• Extend isMissing/isPresent operators to BPM, bit depth and many text fields. (#​5603 by @​deluan)
• Speed up smart playlists that filter on play count, rating or loved status, up to ~14x faster end-to-end (the underlying query alone is over 300x faster). (#​5662 by @​deluan)
• Speed up smart playlists with many negated artist/tag rules, ~160x faster on a real-world case with 120 rules on a 323K-track library. (#​5607 by @​deluan)
• Fix isMissing/isPresent operators on ReplayGain fields. (#​5585 by @​deluan)

Recommendations

• Match similar and top songs across all artists credited on a track, improving results for collaborations. (#​5668 by @​deluan)
• Match ListenBrainz top songs for collaborations using all credited artist MBIDs. (#​5670 by @​deluan)
• Speed up top/similar song matching with batched lookups, up to ~14x faster on large batches. (#​5635 by @​deluan)
• Fix song matching to use artist credits, so artist-MBID specificity works and collaborators match correctly. (#​5637 by @​deluan)

Plugins

• Add a navidrome plugin CLI for managing and inspecting plugins. (#​5682 by @​deluan)
• Expose the song Matcher as a host service for plugins. (#​5643 by @​deluan)
• Share plugin DTOs via a common types package, simplifying plugin development. (#​5655 by @​deluan)

Artwork

• Speed up image resizing and WebP encoding/decoding, up to ~30% faster with far fewer allocations. (#​5652 by @​deluan)
• Fix artist folder images being incorrectly served as album art. (#​5596 by @​deluan)
• Fix WebP crash on 32-bit ARM; WebP encoding is now disabled by default in Docker images. (#​5606 by @​deluan)

Transcoding

• Preserve source metadata when transcoding downloads. (#​5628 by @​deluan)
• Enforce server-side player MaxBitRate on all stream paths. (#​5611 by @​deluan)
• Honor the player's forced transcoding format in the web UI playback flow. (#​5613 by @​deluan)
• Fix partially-written transcodes being served from the cache after a server crash. (#​5657 by @​deluan)

Server

• Enable sharing by default. (#​5714 by @​deluan)
• Fix direct log.Log calls not honoring DevLogLevels. (#​5700 by @​kgarner7)

Database

• Speed up song sorting by album and artist with new sort-order indexes, ~19x faster on large libraries on a cold cache. (#​5706 by @​deluan)
• Skip library filtering when a non-admin user has access to all libraries, making song counts ~19x faster on a 920K-track database. (#​5696 by @​deluan)
• Skip unnecessary annotation joins when counting items, up to ~9x faster list counts, with even larger gains on a cold cache. (#​5694 by @​deluan)
• Make PRAGMA optimize errors non-fatal at startup. (bd3192be0 by @​deluan)

Translations

• Update Turkish translations. (#​5685 by @​deluan)

New Contributors

• @​ranokay made their first contribution in #​5076
• @​devBoi76 made their first contribution in #​5590
• @​draconivis made their first contribution in #​5664

Full Changelog: navidrome/navidrome@v0.62.0...v0.63.0

Helping out

This release is only possible thanks to the support of some awesome people!

Want to be one of them?
You can sponsor, pay me a Ko-fi, or contribute with code.

Where to go next?

• Read installation instructions on our website.
• Host Navidrome on PikaPods or Danian for a simple cloud solution.
• Reach out on Discord, Reddit and Twitter!

v0.62.0

Compare Source

This release introduces support for the OpenSubsonic sonicSimilarity extension, enabling audio-based similarity through the plugin system: when a plugin provides the capability, the new getSonicSimilarTracks and findSonicPath endpoints unlock smarter, sound-based recommendations and playlists. One plugin that implements it is AudioMuse-AI. It also brings a major overhaul to playback reporting and the Now Playing experience — the UI now uses the new OpenSubsonic playbackReport extension, replacing the old scrobble flow with a redesigned panel and configurable reporting interval. On the security front, it hardens the server with stronger ownership and authorization checks across shares, players, and transcoding endpoints, caps concurrent transcodes to prevent ffmpeg-based denial of service, and adds an option to refuse to run as root. Smart playlists gain ReplayGain fields and new isMissing/isPresent operators, and there are five new UI themes to choose from.

Security

This release fixes several reported vulnerabilities. We thank the security researchers who responsibly disclosed them.

• Fix cross-account disclosure of other users' shares (incl. share tokens) by enforcing per-user ownership on share reads. (1e7996f5d, GHSA-3g4p-jhv2-xrxf, reported by @​Wernerina)
• Fix cross-tenant player takeover and share-update IDOR by enforcing ownership atomically on player and share updates. (#​5563, GHSA-x65f-m8x9-pjxm reported by @​tonghuaroot; GHSA-58gr-c777-g23p reported by @​lighthousekeeper1212; GHSA-wx2c-q8g7-4q5p reported by @​CE2Sec)
• Fix unauthenticated Last.fm scrobble session hijack (IDOR) by requiring a signed state token on the link callback. (#​5521, GHSA-8jrh-w926-8rvw, reported by @​geo-chen)
• Fix JWT expiration bypass on public share stream endpoints by validating token expiration and share existence. (#​5426, GHSA-3rfj-qx9q-jghx, reported by @​wooseokdotkim)
• Fix disclosure of admin-only transcoding configuration to non-admin users by restricting transcoding config reads to admins. (#​5564, GHSA-4p3r-6362-833w, reported by @​DavidCarliez)
• Fix missing admin authorization on internet radio station management endpoints by requiring admin access for Subsonic management endpoints. (#​5510, GHSA-jw24-qqrj-633c, reported by @​osageling)
• Cap concurrent transcodes to prevent an ffmpeg-based denial of service, with new per-server and per-user limits. (#​5522 by @​deluan)
• Add EnforceNonRootUser option to exit early if Navidrome is started as root. (#​5373 by @​kopf)
• Split HTML sanitization from plaintext handling. (7e083e079 by @​deluan)

Note: Several of the advisories linked above are still in draft/triage on GitHub at the time of writing. Their links will become publicly accessible once the advisories are published. The fixes themselves are already included in this release.

Configuration Changes

For a complete list of all configuration options, see the Configuration Options documentation.

UI

• Replace UI scrobble with reportPlayback and redesign the Now Playing panel. (#​5448 by @​deluan)
• Add Tokyo Night theme. (#​5497 by @​Metalhearf)
• Add Catppuccin Latte theme. (#​5250 by @​lov3b)
• Add Moonbase themes (Alpha light + Bravo dark). (#​5243 by @​craiglush)
• Add a "Not Starred" filter option. (#​5362 by @​danielbanariba)
• Add a Rescan button to the plugin list empty state. (#​5471 by @​deluan)
• Suppress capitalization and autocorrection for login on mobile keyboards. (#​3783 by @​bdefore)
• Show album tile actions on keyboard focus. (#​5434 by @​danielbanariba)
• Start a new album from track 1 after closing the player. (#​5441 by @​deluan)
• Prevent autoplay when clearing the play queue. (#​5430 by @​deluan)
• Fix Gruvbox Dark colors. (#​5553 by @​Tal0na)
• Update the AMusic theme to use the correct text color for primary confirmation buttons. (#​5509 by @​VirtualWolf)

Smart Playlists

• Add ReplayGain fields to the criteria system. (d9dac4445 by @​deluan)
• Add isMissing and isPresent operators. (#​5436 by @​deluan)
• Relax playlist visibility in inPlaylist/notInPlaylist rules. (#​5411 by @​deluan)
• Optimize smart playlist performance for role and tag criteria. (#​5515 by @​deluan)
• Coerce string booleans in smart playlist rules. (#​5450 by @​deluan)

Subsonic API

• Implement the playbackReport OpenSubsonic extension. (#​5442 by @​deluan)
• Add the sonicSimilarity extension as a plugin capability. (#​5419 by @​deluan)
• Add a groupings field to the OpenSubsonic Child response. (f12e75aa1 by @​deluan)
• Use SQLite RANDOM() sorting in getRandomSongs for faster results. (cf1f190bb by @​deluan)
• Mark AlbumID3 songCount and created as required. (8897ec918 by @​deluan)
• Normalize non-NFKD Unicode letters (ø, æ, œ, ß) in search. (#​5413 by @​deluan)

Transcoding

• Place -ss before -i for fast input seeking. (#​5492 by @​deluan)
• Don't apply server-side override on getTranscodeDecision. (#​5473 by @​deluan)
• Log a warning for invalid or stale transcode tokens. (9a2eb483e by @​deluan)

Scanner

• Respect tag-split config when multiple frames map to the same tag. (#​5193 by @​trek-e)
• Fix error when importing playlists without an admin user. (5b85b2839 by @​deluan)

Artwork

• Fix stale cache and top-level album artwork for multi-disc albums. (#​5457 by @​deluan)
• Prefer album-root images over disc-subfolder images for multi-disc albums. (#​5451 by @​deluan)
• Return the correct timestamp when disc or album cover art changes. (#​5378 by @​bobo-xxx)

Server

• Prevent artwork throttle token starvation on slow clients. (#​5472 by @​deluan)
• Proxy NowPlaying even when ignoreScrobble is set. (#​5559 by @​deluan)
• Make the /api/song path filter work and use startsWith. (#​5566 by @​deluan)
• Preserve unchanged fields on partial REST playlist updates. (#​5542 by @​deluan)
• Allow toggling playlist auto-import and avoid unnecessary artwork reloads. (#​5421 by @​deluan)

Matcher

• Add Matcher.PreferStarred option to bias the fuzzy matcher toward starred/high-rated tracks. (#​5387 by @​deluan)

Plugins

• Add PlaybackReport to the scrobbler capability. (#​5452 by @​deluan)
• Add LibraryID to TrackInfo. (fd930eefd by @​deluan)

CLI

• Add pls export/import subcommands for bulk playlist management. (#​5412 by @​deluan)
• Restore int cast for syscall.Stdin on Windows. (e75ab3b03 by @​deluan)

Build & Dependencies

• Improve Windows support: the Go test suite now runs on Windows CI, with previously-skipped Subsonic, artwork, watcher, and scheduler tests enabled and fixed. (#​5380, #​5427, #​5416 by @​deluan)
• Upgrade Go to 1.26. (#​5361 by @​deluan)
• Enable native libwebp encoding in the Docker image. (#​5350 by @​deluan)
• Update TagLib to 2.3. (e55a35544 by @​deluan)

Translations

• Add Estonian translation. (725f6ab34 by @​deluan)
• Update Indonesian translations from POEditor. (#​5575 by @​deluan)
• Update Spanish translations and add missing gain keys. (#​5433 by @​danielbanariba)
• Update Basque localisation. (#​5364 by @​xabirequejo)
• Update German, Finnish, Galician, Dutch, Slovak, Thai, and Chinese (traditional) translations from POEditor. (#​5351 by @​deluan)
• Update Serbian translation. (#​5444 by @​nenadjokic)
• Update Traditional Chinese translation. (#​5470 by @​IEEE-754)
• Complete Italian translation. (#​5407 by @​DanieleMassa)

New Contributors

• @​bdefore made their first contribution in #​3783
• @​craiglush made their first contribution in #​5243
• @​lov3b made their first contribution in #​5250
• @​danielbanariba made their first contribution in #​5362
• @​kopf made their first contribution in #​5373
• @​bobo-xxx made their first contribution in #​5378
• @​DanieleMassa made their first contribution in #​5407
• @​nenadjokic made their first contribution in #​5444
• @​IEEE-754 made their first contribution in #​5470
• @​Metalhearf made their first contribution in #​5497
• @​VirtualWolf made their first contribution in #​5509
• @​Tal0na made their first contribution in #​5553

Full Changelog: navidrome/navidrome@v0.61.2...v0.62.0

Helping out

This release is only possible thanks to the support of some awesome people!

Want to be one of them?
You can sponsor, pay me a Ko-fi, or contribute with code.

Where to go next?

• Read installation instructions on our website.
• Host Navidrome on PikaPods or Danian for a simple cloud solution.
• Reach out on Discord, Reddit and Twitter!